home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Toolbox / Visual Basic Toolbox (P.I.E.)(1996).ISO / setup_ut / setupb / readme.txt < prev    next >
Text File  |  1994-10-18  |  5KB  |  144 lines
  1.                                      *************************************
  2.                                      * Program:   SETUP.EXE              *
  3.                                      * Version:   1.0a                   *
  4.                                      * Date:      18th October 1994      * 
  5.                                      * Author:    Simon Barrett          *
  6.                                      *************************************
  7.  
  8. Description:
  9. ------------
  10.  
  11. SETUP.EXE is a replacement for the file of the same name provided by
  12. Microsoft as part of the Visual Basic Setup Kit.
  13.  
  14. This version of Setup differs from the Microsoft program in
  15. that the files required for running the main setup program are
  16. copied to a temporary directory which is removed once the main setup 
  17. program has finished.
  18.  
  19. This has the benefit that:
  20.  
  21. *    It is possible to install a Visual Basic program even if 
  22.      another VB program is running.
  23.  
  24. *    Setup will copy the setup files even if there is a clash with open,
  25.      write protected or older versions of files.
  26.  
  27.  
  28. Operation:
  29. ----------
  30.  
  31. Once SETUP is run it carries out the following:
  32.  
  33. *    Creates a temporary directory (BLACKCAT.TMP) in the 
  34.      Windows directory.
  35.  
  36. *    Copies the files listed in SETUP.LST to this directory (See description 
  37.      of SETUP.LST below).
  38.  
  39. *    Runs the main installation program (this is the first file in 
  40.      the file list).
  41.  
  42. *    Deletes the files in the temporary directory and removes the directory.
  43.  
  44.  
  45. SETUP.LST:
  46. ----------
  47.  
  48. A SETUP.LST file must be included on the first installation disc and
  49. must take the following format.
  50.  
  51. *    Files that are to be copied by SETUP are listed on separate lines.
  52.  
  53. *    The part of the line before the = sign is the name of the file on
  54.      the setup disc.
  55.  
  56. *    The part after the = sign is the name of the file once it is 
  57.      copied to the temporary directory.
  58.  
  59. *    Comments can be included staring with a semi-colon.
  60.  
  61. *    There is a limit of 20 files.
  62.  
  63. *    All files to be copied by SETUP must be on the first disc.
  64.  
  65. *    Setup will copy and decompress compressed files.
  66.  
  67.      
  68. Example:
  69. --------
  70.      
  71.      mysetup.ex_   = mysetup.exe
  72.      vbrun200.dl_  = vbrun200.dll
  73.      threed.vb_    = threed.vbx
  74.      ver.dl_       = ver.dll
  75.      blackcat.dl_  = blackcat.dll
  76.  
  77.  
  78. Also included with this version of SETUP.EXE is BLACKCAT.DLL.
  79.  
  80. BLACKCAT.DLL is a replacement for SETUPKIT.DLL and is needed if the
  81. main setup program is to run correctly.  See the section below on 
  82. adapting SETUP1.MAK for use with this version of SETUP.
  83.  
  84.  
  85. Adapting SETUP1.MAK for use with SETUP.EXE:
  86. -------------------------------------------
  87.  
  88. Because files are copied to a temporary directory there are a 
  89. few implications for the format of the example Setup program
  90. provided with Visual Basic.
  91.  
  92. *    All 'Declare' statements for SETUPKIT.DLL should be removed.
  93.  
  94. *    The following Declare statement should be used instead:
  95.  
  96.      Declare Function DiskSpaceFree Lib "BLACKCAT.DLL" (ByVal Drive As Integer) As Long
  97.  
  98.      
  99.      Function GetDiskSpaceFree (drive As String) As Long
  100.        Dim d As Integer
  101.        d = (Asc(UCase$(Left$(drive, 1)))) - 64
  102.        GetDiskSpaceFree = DiskSpaceFree(d)
  103.      End Function
  104.  
  105. *    d represents the drive for which information about the amount of
  106.      free space is required A: = 1,  B: = 2,  C: = 3 etc.
  107.  
  108. *    If changes are made to the current drive and/or directory as in
  109.      'CreatePath' and 'IsPathValid' the drive and directory should be
  110.      returned to App.Path before a call is made to a 'dll'.  This is 
  111.      necessary as Visual Basic loads a DLL when a call is made to a
  112.      DLL function rather than when the program loads.
  113.  
  114. *    SETUP passes the source path with a trailing '\' as a parameter
  115.      when it runs the main installation program.
  116.  
  117.  
  118. Registering SETUP.EXE:
  119. ----------------------
  120.  
  121. By registering SETUP.EXE you will obtain the following benefits:
  122.  
  123. *    Receive full version without 'Register' message.
  124.  
  125. *    Receive technical support and advice concerning the use of
  126.      SETUP.EXE and BLACKCAT.DLL
  127.  
  128. *    Receive updates from time to time.
  129.  
  130. The cost of registering is $12 by contacting me at:
  131.  
  132.     Simon Barrett
  133.     The Barn, Cwm Camlais,
  134.     Brecon, Powys, U.K. LD3 8TD
  135.     Phone +44 (0) 874 636835
  136.     FAX   +44 (0) 874 636835
  137.     Compuserve: 100102,1247
  138.     Internet:   100102,1247@compuserve.com
  139.  
  140.  
  141. Windows is a trademark of the Microsoft Corporation.
  142.  
  143.  
  144.